home *** CD-ROM | disk | FTP | other *** search
/ Chip 2005 March / CMCD0305.ISO / Software / Shareware / Programare / restuner / ResTuner_setup.exe / {app} / restuner.chm / basics - res - manifest.htm < prev    next >
Encoding:
Extensible Markup Language  |  2005-01-11  |  9.4 KB  |  238 lines
  1. <html>
  2. <head>
  3. <title>Application Manifest</title>
  4. <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  5. <link rel="stylesheet" type="text/css" href="help.css">
  6. </head>
  7. <table width="100%" border="0" bordercolor="#000000" bgcolor="#000000">
  8.   <tr> 
  9.     <td bgcolor="#000000" height="19"> 
  10.       <div align="left"><font face="Tahoma"><b><font size="4">  <font size="5" color="#FFFFFF">Application 
  11.         Manifest Resource </font></font></b></font></div>
  12.     </td>
  13.   </tr>
  14. </table>
  15. <p>An <b>Application Manifest</b> is an XML file that describes and identifies 
  16.   the shared and private side-by-side assemblies that an application should bind 
  17.   to at run time. More detailed information can be found on the <img src="extlink.gif" width="18" height="9"> 
  18.   <a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/sbscs/sidebysideref_03ol.asp" target="_blank">Microsoft 
  19.   MSDN</a> site. </p>
  20.       <p>The following is an example of an application manifest for an
  21.       application named MySampleApp.exe. The application consumes the Common
  22.       Controls side-by-side assembly (COMCTL32).</p>
  23.       <PRE><?xml version="1.0"
  24. encoding="UTF-8" standalone="yes"?>
  25. <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  26.   <assemblyIdentity type="win32"
  27.                     name="myOrganization.myDivision.mySampleApp"
  28.                     version="6.0.0.0"
  29.                     processorArchitecture="x86"
  30.                     publicKeyToken="6595b64144ccf1df"
  31.   />
  32.   <description>Your app description here</description>
  33.   <dependency>
  34.     <dependentAssembly>
  35.       <assemblyIdentity type="win32"
  36.                         name="Microsoft.Windows.Common-Controls"
  37.                         version="6.0.0.0"
  38.                         processorArchitecture="X86"
  39.                         publicKeyToken="6595b64144ccf1df"
  40.                         language="*"
  41.       />
  42.     </dependentAssembly>
  43.   </dependency>
  44. </assembly></PRE>
  45. <p><b>Elements</b></p>
  46. <p>Names of elements and attributes are case-sensitive. The values of elements 
  47.   and attributes are case-insensitive, except for the value of the type attribute. 
  48. <dl> 
  49.   <p><b>assembly</b> 
  50.   <p>A container element. Its first subelement must be a <b>noInherit</b> or 
  51.     <b>assemblyIdentity</b> element. Required. 
  52.     <p>The <b>assembly</b> element has the following attributes. 
  53.     <table>
  54.       <tbody> 
  55.       <tr valign=top> 
  56.         <th align=left width="27%"> 
  57.           
  58.         <p><b>Attribute</b></p>
  59.         </th>
  60.         <th align=left width="73%"> 
  61.           
  62.         <p><b>Description</b></p>
  63.         </th>
  64.       </tr>
  65.       <tr valign=top> 
  66.         <td width="27%"> 
  67.           <p>manifestVersion</p>
  68.         </td>
  69.         <td width="73%"> 
  70.           <p>The manifestVersion attribute must be set to 1.0.</p>
  71.         </td>
  72.       </tr>
  73.       </tbody> 
  74.     </table>
  75.     <br>
  76.     <p></p>
  77.   <p><b>noInherit</b> 
  78.   <dd>
  79.     <p>Include this element in an application manifest to set the activation contexts 
  80.       generated from the manifest with the "no inherit" flag. When this flag is 
  81.       not set in an activation context, and the activation context is active, 
  82.       it is inherited by new threads in the same process, windows, window procedures, 
  83.       and Asynchronous Procedure Calls. Setting this flag prevents the new object 
  84.       from inheriting the active context. 
  85.     <p>The <b>noInherit</b> element is optional and typically omitted. Most assemblies 
  86.       do not work correctly using a no-inherit activation context because the 
  87.       assembly must be explicitly designed to manage the propagation of their 
  88.       own activation context. The use of the <b>noInherit</b> element requires 
  89.       that any dependent assemblies referenced by the application manifest have 
  90.       a <b>noInheritable</b> element in their assembly manifest. 
  91.     <p>If <b>noInherit</b> is used in a manifest, it must be the first subelement 
  92.       of the <b>assembly</b> element. The <b>assemblyIdentity</b> element should 
  93.       come immediately after the <b>noInherit</b> element. If <b>noInherit</b> 
  94.       is not used, <b>assemblyIdentity</b> must be the first subelement of the 
  95.       <b>assembly</b> element. The <b>noInherit</b> element has no child elements. 
  96.       It is not a valid element in assembly manifests. </p>
  97.   <p><b>assemblyIdentity</b> 
  98.   <dd><p>As the first subelement of an <b>assembly</b> element, <b>assemblyIdentity</b> 
  99.     describes and uniquely identifies the application owning this application 
  100.     manifest. As the first subelement of a <b>dependentAssembly</b> element, <b>assemblyIdentity</b> 
  101.     describes a side-by-side assembly required by the application. Note that every 
  102.     assembly referenced in the application manifest requires an <b>assemblyidentity</b> 
  103.     that exactly matches the <b>assemblyIdentity</b> in the referenced assembly's 
  104.     own assembly manifest. 
  105.     <p>The element has the following attributes. It has no subelements. 
  106.     <table>
  107.       <tbody> 
  108.       <tr valign=top> 
  109.         <th align=left width="24%"> 
  110.           <p><b>Attribute</b></p>
  111.         </th>
  112.         <th align=left width="76%"> 
  113.           <p><b>Description</b></p>
  114.         </th>
  115.       </tr>
  116.       <tr valign=top> 
  117.         <td width="24%"> 
  118.           <p>type</p>
  119.         </td>
  120.         <td width="76%"> 
  121.           <p>Specifies the application or assembly type. The value must be win32 
  122.             and all in lower case. Required.</p>
  123.         </td>
  124.       </tr>
  125.       <tr valign=top> 
  126.         <td width="24%"> 
  127.           <p>name</p>
  128.         </td>
  129.         <td width="76%"> 
  130.           <p>Uniquely names the application or assembly. Use the following format 
  131.             for the name: Organization.Division.Name. For example Microsoft.Windows.mysampleApp. 
  132.             Required.</p>
  133.         </td>
  134.       </tr>
  135.       <tr valign=top> 
  136.         <td width="24%"> 
  137.           <p>language</p>
  138.         </td>
  139.         <td width="76%"> 
  140.           <p>Identifies the language of the application or assembly. Optional. 
  141.             If the application or assembly is language-specific, specify the DHTML 
  142.             language code. </p>
  143.           <p>In the <b>assemblyIdentity</b> of an application intended for worldwide 
  144.             use (language neutral) omit the language attribute. </p>
  145.           <p>In an <b>assemblyIdentity</b> of an assembly intended for worldwide 
  146.             use (language neutral) set the value of language to "*". </p>
  147.         </td>
  148.       </tr>
  149.       <tr valign=top> 
  150.         <td width="24%"> 
  151.           <p>processorArchitecture</p>
  152.         </td>
  153.         <td width="76%"> 
  154.           <p>Specifies the processor. The valid values are x86 for 32-bit Windows 
  155.             and IA-64 for 64-bit Windows. Optional.</p>
  156.         </td>
  157.       </tr>
  158.       <tr valign=top> 
  159.         <td width="24%"> 
  160.           <p>version</p>
  161.         </td>
  162.         <td width="76%"> 
  163.           <p>Specifies the application or assembly version. Use the four-part 
  164.             version format: mmmmm.nnnnn.ooooo.ppppp. Each of the parts separated 
  165.             by periods can be 0-65535 inclusive. Required.</p>
  166.         </td>
  167.       </tr>
  168.       <tr valign=top> 
  169.         <td width="24%"> 
  170.           <p>publicKeyToken</p>
  171.         </td>
  172.         <td width="76%"> 
  173.           <p>A 16-character hexadecimal string representing the last 8 bytes of 
  174.             the SHA-1 hash of the public key under which the application or assembly 
  175.             is signed. The public key used to sign the catalog must be 2048 bits 
  176.             or greater. Required for all shared side-by-side assemblies.</p>
  177.         </td>
  178.       </tr>
  179.       </tbody> 
  180.     </table>
  181.     <br>
  182.     <p></p>
  183.   <p><b>dependency</b> 
  184.   <dd><p>Contains at least one <b>dependentAssembly</b>. It has no attributes. Optional. 
  185.   <p><b>dependentAssembly</b> 
  186.   <dd><p>The first subelement of <b>dependentAssembly</b> must be an <b>assemblyIdentity</b> 
  187.     element that describes a side-by-side assembly required by the application. 
  188.     Every <b>dependentAssembly</b> must be inside exactly one <b>dependency</b>. 
  189.     It has no attributes. 
  190.   <p><b>file</b> 
  191.   <dd><p>Specifies files that are private to the application. Optional. 
  192.     <p>The element has the attributes shown in the following table. 
  193.     <table>
  194.       <tbody> 
  195.       <tr valign=top> 
  196.         <th align=left width="24%"> 
  197.           <p><b>Attribute</b></p>
  198.         </th>
  199.         <th align=left width="76%"> 
  200.           <p><b>Description</b></p>
  201.         </th>
  202.       </tr>
  203.       <tr valign=top> 
  204.         <td width="24%"> 
  205.           <p>name </p>
  206.         </td>
  207.         <td width="76%"> 
  208.           <p>Name of the file. For example, Comctl32.dll.</p>
  209.         </td>
  210.       </tr>
  211.       <tr valign=top> 
  212.         <td width="24%"> 
  213.           <p>hashalg</p>
  214.         </td>
  215.         <td width="76%"> 
  216.           <p>Algorithm used to create a hash of the file. This value should be 
  217.             SHA1.</p>
  218.         </td>
  219.       </tr>
  220.       <tr valign=top> 
  221.         <td width="24%"> 
  222.           <p>hash</p>
  223.         </td>
  224.         <td width="76%"> 
  225.           <p>A hash of the file referred to by name. A hexadecimal string of length 
  226.             depending on the hash algorithm.</p>
  227.         </td>
  228.       </tr>
  229.       </tbody> 
  230.     </table>
  231.     
  232.   </dd>
  233. </dl>
  234. <p> </p>
  235. <SCRIPT language="JavaScript" src="footer.js" type="text/javascript"></SCRIPT>
  236. </body>
  237. </html>
  238.